public abstract class CollectionFactory
extends java.lang.Object
Mainly for internal use within the framework.
The goal of this class is to avoid runtime dependencies on a specific Java version, while nevertheless using the best collection implementation that is available at runtime.
Modifier and Type | Field and Description |
---|---|
private static java.util.Set<java.lang.Class<?>> |
approximableCollectionTypes |
private static java.util.Set<java.lang.Class<?>> |
approximableMapTypes |
Constructor and Description |
---|
CollectionFactory() |
Modifier and Type | Method and Description |
---|---|
private static java.lang.Class<? extends java.lang.Enum> |
asEnumType(java.lang.Class<?> enumType)
Cast the given type to a subtype of
Enum . |
static <E> java.util.Collection<E> |
createApproximateCollection(java.lang.Object collection,
int capacity)
Create the most approximate collection for the given collection.
|
static <K,V> java.util.Map<K,V> |
createApproximateMap(java.lang.Object map,
int capacity)
Create the most approximate map for the given map.
|
static <E> java.util.Collection<E> |
createCollection(java.lang.Class<?> collectionType,
java.lang.Class<?> elementType,
int capacity)
Create the most appropriate collection for the given collection type.
|
static <E> java.util.Collection<E> |
createCollection(java.lang.Class<?> collectionType,
int capacity)
Create the most appropriate collection for the given collection type.
|
static <K,V> java.util.Map<K,V> |
createMap(java.lang.Class<?> mapType,
java.lang.Class<?> keyType,
int capacity)
Create the most appropriate map for the given map type.
|
static <K,V> java.util.Map<K,V> |
createMap(java.lang.Class<?> mapType,
int capacity)
Create the most appropriate map for the given map type.
|
static boolean |
isApproximableCollectionType(java.lang.Class<?> collectionType)
Determine whether the given collection type is an approximable type,
i.e.
|
static boolean |
isApproximableMapType(java.lang.Class<?> mapType)
Determine whether the given map type is an approximable type,
i.e.
|
private static final java.util.Set<java.lang.Class<?>> approximableCollectionTypes
private static final java.util.Set<java.lang.Class<?>> approximableMapTypes
public static boolean isApproximableCollectionType(java.lang.Class<?> collectionType)
createApproximateCollection(java.lang.Object, int)
can approximate.collectionType
- the collection type to checktrue
if the type is approximablepublic static <E> java.util.Collection<E> createApproximateCollection(java.lang.Object collection, int capacity)
collection
- the original collection objectcapacity
- the initial capacityisApproximableCollectionType(java.lang.Class<?>)
,
LinkedList
,
ArrayList
,
EnumSet
,
TreeSet
,
LinkedHashSet
public static <E> java.util.Collection<E> createCollection(java.lang.Class<?> collectionType, int capacity)
Delegates to createCollection(Class, Class, int)
with a
null
element type.
collectionType
- the desired type of the target collectioncapacity
- the initial capacitypublic static <E> java.util.Collection<E> createCollection(java.lang.Class<?> collectionType, java.lang.Class<?> elementType, int capacity)
collectionType
- the desired type of the target collection; never null
elementType
- the collection's element type, or null
if not known
(note: only relevant for EnumSet
creation)capacity
- the initial capacityLinkedHashSet
,
ArrayList
,
TreeSet
,
EnumSet
public static boolean isApproximableMapType(java.lang.Class<?> mapType)
createApproximateMap(java.lang.Object, int)
can approximate.mapType
- the map type to checktrue
if the type is approximablepublic static <K,V> java.util.Map<K,V> createApproximateMap(java.lang.Object map, int capacity)
map
- the original Map objectcapacity
- the initial capacityisApproximableMapType(java.lang.Class<?>)
,
EnumMap
,
TreeMap
,
LinkedHashMap
public static <K,V> java.util.Map<K,V> createMap(java.lang.Class<?> mapType, int capacity)
Delegates to createMap(Class, Class, int)
with a
null
key type.
mapType
- the desired type of the target Mapcapacity
- the initial capacitypublic static <K,V> java.util.Map<K,V> createMap(java.lang.Class<?> mapType, java.lang.Class<?> keyType, int capacity)
mapType
- the desired type of the target MapkeyType
- the map's key type, or null
if not known
(note: only relevant for EnumMap
creation)capacity
- the initial capacityLinkedHashMap
,
TreeMap
,
LinkedMultiValueMap
,
EnumMap
private static java.lang.Class<? extends java.lang.Enum> asEnumType(java.lang.Class<?> enumType)
Enum
.enumType
- the enum type, never null
Enum
java.lang.IllegalArgumentException
- if the given type is not a subtype of Enum